package com.study.map.service;

import com.study.map.dto.IpLocationRequest;
import com.study.map.dto.IpLocationResponse;
import com.study.map.exception.MapServiceException;

/**
 * IP定位服务接口
 *
 * @author study
 * @date 2025-08-31
 */
public interface IIpLocationService {

    /**
     * IP定位：根据IP地址获取位置信息
     *
     * @param request IP定位请求参数
     * @return IP定位结果
     * @throws MapServiceException 地图服务异常
     */
    IpLocationResponse ipLocation(IpLocationRequest request) throws MapServiceException;

    /**
     * IP定位：根据IP地址获取位置信息
     *
     * @param ip IP地址
     * @return IP定位结果
     * @throws MapServiceException 地图服务异常
     */
    IpLocationResponse ipLocation(String ip) throws MapServiceException;
}